Introduction

The PicketLink Integration Test is a sub-project that provides some unit and integration tests to verify the reliability on major design items. You can clone this project from:

• https://github.com/picketlink/integration-tests

As PicketLink supports different containers, the tests need to run in each of them. The table bellow lists all the supported containers:

requisites

Project Organization

Basically, the project is organized in two modules:

• unit-test
  Contains test classes and resources, only. For each feature there is a sub-module with specific tests and resources (Eg.: saml, ws-trust, etc).

  • util       : Utility classes to be used by the test cases.

  • saml     : SAML test cases.

  • ws-trust: WS-Trust test cases.

  • xacml  : XACML test cases.

  • trust     : PicketLink JAAS LoginModules test cases.

• integration-tests
  Contains all the configurations required to run the tests on a specific server. For each target container there is a sub-module (Eg.: jboss-as7, jboss-as5, tomcat-6, etc).

  • integration-webapps: Contains some applications used during the tests.

  • jboss-as5                  : Configures a JBoss AS5 installation and execute the tests against it.

  • jboss-as5-cxf            : Configures a JBoss AS5 installation with the JBossWS CXF Stack configured and execute the tests against it.

  • jboss-as6                  : Configures a JBoss AS6 installation and execute the tests against it.

  • jboss-as7                  : Configures a JBoss AS7 installation and execute the tests against it.

  • tomcat-6                   : Configures a Apache Tomcat 6 installation and execute the tests against it.

Running the Tests

In order to execute the tests, you need to use one of the configured Maven Profiles.

The example bellow shows how you can execute all tests:

mvn -Pall-tests clean install

mvn -Pws-trust-tests clean install

mvn -Pall-tests -DforceBinding=jbas5 clean verify

How to create Test Cases

As said before, each feature has its own module, which contains only the specific test cases for that feature.

The following sections will show how to create a SAML test case. The same rule apply for the WS-Trust, XACML, etc.

@TargetContainers ({"jbas5", "jbas6", "jbas7", "tomcat6"})
public class SAML2ExampleTestCase extends AbstractSAMLIntegrationTests {


    @Test
    public void testMethodExample() {
       // put your code here
    }
    
    @Deployment(name = "idp", testable = false)
    @TargetsContainer("jboss")
    public static WebArchive createIDPDeployment() throws ConfigurationException, ProcessingException, ParsingException,
            InterruptedException {
        WebArchive idp = MavenArtifactUtil.getQuickstartsMavenArchive("idp");
        
        addTrustedDomain(idp, getServerAddress());
        
        return idp;
    }


    @Deployment(name = "sales-post", testable = false)
    @TargetsContainer("jboss")
    public static WebArchive createSalesPostDeployment() {
        return MavenArtifactUtil.getQuickstartsMavenArchive("sales-post");
    }
}